home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / dvgt / DVGT351.README < prev    next >
Text File  |  1993-08-24  |  4KB  |  98 lines
  1. DVGT351.README (BETA) - 18:18 GMT +10:00 Wed 25 August 1993.
  2. ------------------------------------------------------------
  3.  
  4. This is a brief overview of dvgt 3.51 beta.
  5.  
  6. WHAT IS dvgt 3.5?
  7. -----------------
  8.  
  9. dvgt 3.5 (version 3 mod 5) is an enhancement (with permission) of
  10. Andrew Trevorrow's `dvitovdu', a public domain TeX dvi file previewer
  11. familiar to some Vax/VMS users.  Specifically, dvgt is based on
  12. Andrew's unix version 3.0 of dvitovdu.
  13.  
  14. dvitovdu was written in Modula-2.  dvgt, however, is in ANSI C
  15. (but old-style C is used if the compiler does not define __STDC__);
  16. it has been massaged for Sun/OS on a Sun 4, Solaris 2.1 on a Sparc 10,
  17. and for AIX on an IBM Risc/6000.
  18.  
  19. Like dvitovdu, dvgt has Terse, Box and Full preview modes.  Terse mode
  20. uses the text mode of the VDU, and is insensitive to zoom.  Box mode
  21. shows the bounding boxes of characters.  Full mode gives a graphically
  22. rendered preview.  On non-graphic terminals at low screen
  23. magnifications, Terse mode is the most useful, but as one zooms in,
  24. Box and Full modes become more and more accurate.
  25.  
  26. dvgt issues a help page to new users, and 3.5 gives more information
  27. when it exits.
  28.  
  29. dvgt 3.5 tries to open a log file, `dvgt.vlg', to catch messages that
  30. occur before option parsing is complete.  If a DVI file named
  31. `document.dvi' is to be viewed, dvgt will soon try to open a second
  32. log file named `document.vlg'; if that fails, `dvgt.vlg' continues to
  33. be used.  If `dvgt.vlg' cannot be opened, then no logfile is written.
  34.  
  35. Version 3.5 allows the search of multiple directories when seeking
  36. TFM or PK fonts.  Since both AIX and Sun/OS are forms of unix,
  37. alternative directories are separated by a colon `:' character.
  38.  
  39. Much larger PK bitmaps can now be handled, as the former fixed-size
  40. bitmap data structure has been replaced by a call to malloc.
  41. A side-effect is that small bitmaps are automatically stored
  42. efficiently.
  43.  
  44. dvgt now has an enlarged set of environment variables, all prefixed
  45. with "DV_".  For example, DV_TERM can be set independently of the
  46. normal TERM variable.  (A user of 3.4 requested that.)
  47.  
  48. In version 3.5, many of the commands were altered.  See the "help"
  49. file in the "help" directory for the specifics.  A new command,
  50. control-L, refreshes the screen, though only after the whole command
  51. line has been parsed.  This behavior is typical of dvgt commands, and
  52. was present in dvitovdu, perhaps for the benefit of slow connections.
  53.  
  54. dvgt's font search strategy is now to seek a PK font first; in Full
  55. mode this gives a passably accurate representation of the text.  If
  56. that fails, and the font has a `PostScript prefix' (as per the "-p"
  57. option), then the TFM is tried and outlines displayed (like Box mode);
  58. next try is the dummy PK font, then the correct TFM, then the dummy
  59. TFM.  If all else fails, dvgt writes ascii text (as in Terse mode);
  60. this uses cmr encoding, so it's likely to misidentify characters from
  61. other fonts.
  62.  
  63. Earlier versions of dvgt have been used in the USA for English text,
  64. and in Japan to display text using Japanese fonts.  Osaka University
  65. was recently (April 93) porting it to a DECStation under Ultrix.
  66.  
  67. The author uses dvgt to preview dvi files remotely, using NCSA Telnet
  68. or MS-Kermit.  Communication protocols are complex - and in Telnet's
  69. case, incomplete - systems, and use of dvgt may require some
  70. experimentation to give good results for graphic preview.  For NCSA
  71. Telnet, the "ncsatel" vdu driver appears to give satisfactory results,
  72. thanks to input from Vijay (vijay@ncst.ernet.in).
  73.  
  74. WHAT IS dvgt 3.51?
  75. ------------------
  76.  
  77. Version 3.51 is revision 1 of 3.5, containing bug fixes for non-ANSI
  78. compilers, and for mixed systems containing an ANSI compiler and a
  79. non-ANSI library.
  80.  
  81. There are now separate Makefiles for gcc and Sun's cc.
  82.  
  83. The PK font environment variable TEXPKS, used by dvips, is now used;
  84. it takes precedence over the more common PKFONTS.
  85.  
  86. A Bourne shell script, "sane", is provided, in case dvgt leaves the
  87. screen messed up.  This may be modified, if and as required for the
  88. local installation.
  89.  
  90. NOTE:  strings are limited to eighty (80) characters; if paths, for
  91. example, are longer than this, then you may increase the value of
  92. the constant "maxstring" #defined in the file "src/globals.h".
  93.  
  94. As the TODO now records, I wish to use dynamic strings for paths in
  95. a future release.
  96.  
  97. Geoffrey Tobin
  98.